.TH E1432_READ_REGISTER 3 E1432
.SH NAME
.nf
e1432_read_register \- Read 16-bit register from a single E1432
e1432_write_register \- Write 16-bit register to a single E1432
e1432_read32_register \- Read 32-bit register from a single E1432
e1432_write32_register \- Write 32-bit register to a single E1432
.fi
.IX e1432_read_register(3) 3
.IX e1432_write_register(3) 3
.IX e1432_read32_register(3) 3
.IX e1432_write32_register(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_read_register(E1432ID hw, SHORTSIZ16 ID,
                               LONGSIZ32 regOffset, SHORTSIZ16 *data)
SHORTSIZ16 e1432_write_register(E1432ID hw, SHORTSIZ16 ID,
                                LONGSIZ32 regOffset, SHORTSIZ16 data)
SHORTSIZ16 e1432_read32_register(E1432ID hw, SHORTSIZ16 ID,
                                 LONGSIZ32 regOffset, LONGSIZ32 *data)
SHORTSIZ16 e1432_write32_register(E1432ID hw, SHORTSIZ16 ID,
                                  LONGSIZ32 regOffset, LONGSIZ32 data)
.cE
.SH DESCRIPTION
\fIe1432_read_register\fR reads the contents of a 16-bit register of
an E1432 module, identified by the ID from any one of its channels.

\fIe1432_write_register\fR writes data to a particular 16-bit register
of an E1432 module, identified by the ID from any one of its channels.

\fIe1432_read32_register\fR reads the contents of a 32-bit register of
an E1432 module, identified by the ID from any one of its channels.

\fIe1432_write32_register\fR writes data to a particular 32-bit
register of an E1432 module, identified by the ID from any one of its
channels.

Normally, these functions trap bus errors that might occur while
reading or writing a register, and return the error \fBERR1430_BUS_ERROR\fR
if a bus error occurs.  This behavior can be changed by using the
\fIe1432_set_try_recover\fR function.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

\fIID\fR is the ID of a single channel which is used to identify the
module.

\fIregOffset\fR is the offset of the register relative to the base
address of the E1432.  Register offsets have defines of the form
\fBE1432_\fI<register_name>\fB_REG\fR in the file \fBe1432.h\fR.  For
instance, \fBE1432_VXI_ID_REG\fR is at register offset 0.  The list of E1432
registers, and their detailed description, may be found in appendix A
of the HP E1432A users's guide.

\fIdata\fR is the value of the data, to be read from, or to be written
into, the register.
.ne 3
.SH "RESET VALUE"
Not applicable.
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_get_register_address, e1432_set_try_recover
.ad
